home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / Concat.3 < prev    next >
Encoding:
Text File  |  1994-09-20  |  1.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tcl_Concat(3)        Tcl Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tcl_Concat - concatenate a collection of strings
  12.  
  13. SYNOPSIS
  14.      #include <tcl.h>
  15.  
  16.      char *
  17.      Tcl_Concat(_a_r_g_c, _a_r_g_v)
  18.  
  19. ARGUMENTS
  20.      int_a_r_g_c(in)
  21.      Number of strings.
  22.  
  23.      char*_a_r_g_v[](in)
  24.      Array of strings to concatenate.  Must have _a_r_g_c entries.
  25. _________________________________________________________________
  26.  
  27.  
  28. DESCRIPTION
  29.      Tcl_Concat is a utility procedure used by several of the Tcl
  30.      commands.   Given  a  collection of strings, it concatenates
  31.      them together  into  a  single  string,  with  the  original
  32.      strings  separated  by  spaces.  This procedure behaves dif-
  33.      ferently than Tcl_Merge, in that the  arguments  are  simply
  34.      concatenated: no effort is made to ensure proper list struc-
  35.      ture.  However, in most common usage the arguments will  all
  36.      be  proper  lists  themselves;   if  this  is true, then the
  37.      result will also have proper list structure.
  38.  
  39.      Tcl_Concat eliminates leading and trailing white space as it
  40.      copies  strings  from  argv to the result.  If an element of
  41.      argv consists of nothing but white space, then  that  string
  42.      is  ignored entirely.  This white-space removal was added to
  43.      make the output of the concat command cleaner-looking.
  44.  
  45.      The result string is dynamically allocated  using  malloc();
  46.      the  caller  must  eventually  release  the space by calling
  47.      free().
  48.  
  49.  
  50. KEYWORDS
  51.      concatenate, strings
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.